@bendyline/squisq 1.4.0 → 1.4.1

package/dist/doc/index.d.ts

@@ -1,10 +1,5 @@
-export * from './templates/index.js';
-export * from './utils/animationUtils.js';
-export * from './utils/themeUtils.js';
-export { markdownToDoc, flattenBlocks, countBlocks, getBlockDepth } from './markdownToDoc.js';
-export type { MarkdownToDocOptions } from './markdownToDoc.js';
-export { docToMarkdown } from './docToMarkdown.js';
-export { getLayers } from './getLayers.js';
-export type { RenderContext } from './getLayers.js';
-export { resolveAudioMapping, scoreTextSimilarity } from './audioMapping.js';
-//# sourceMappingURL=index.d.ts.map
+export { AccentLayout, AudioSegmentTiming, CoverBlockInput, DEFAULT_LAYOUT, DocStylePreset, ExpandDocBlocksOptions, MarkdownToDocOptions, RenderContext, TEMPLATE_ALIASES, adjustY, comparisonBar, countBlocks, coverBlock, createAccentLayers, dataTable, dateEvent, definitionCard, docToMarkdown, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, factCard, flattenBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, leftFeature, listBlock, mapBlock, markdownToDoc, photoGrid, pullQuote, quoteBlock, resolveAudioMapping, resolveColorScheme, resolveTemplateName, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shouldUseShadow, statHighlight, templateRegistry, themedFontSize, titleBlock, twoColumn, videoPullQuote, videoWithCaption } from '../story/index.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BHjJ0Qx6.js';
+export { t as DocBlock, E as LayoutHints, R as PersistentLayerConfig, _ as RenderStyle, a9 as TemplateBlock, aa as TemplateContext, af as Theme, ag as ThemeColorPalette, ah as ThemeColorScheme, ak as ThemeStyle, al as ThemeTypography, ar as VIEWPORT_PRESETS, av as ViewportConfig, aw as ViewportOrientation, ax as ViewportPreset, aB as createTemplateContext, aG as getLayoutHints, aK as getTwoColumnPositions, aL as getViewport, aM as getViewportOrientation, aO as isTemplateBlock, aS as scaledFontSize } from '../Doc-BeSeH2iX.js';
+import '../types-BdZkdJ3z.js';
+import '../ContentContainer-DNx460y8.js';

package/dist/doc/index.js

@@ -1,8 +1,146 @@
-export * from './templates/index.js';
-export * from './utils/animationUtils.js';
-export * from './utils/themeUtils.js';
-export { markdownToDoc, flattenBlocks, countBlocks, getBlockDepth } from './markdownToDoc.js';
-export { docToMarkdown } from './docToMarkdown.js';
-export { getLayers } from './getLayers.js';
-export { resolveAudioMapping, scoreTextSimilarity } from './audioMapping.js';
+import {
+  DEFAULT_LAYOUT,
+  TEMPLATE_ALIASES,
+  adjustY,
+  comparisonBar,
+  countBlocks,
+  coverBlock,
+  createAccentLayers,
+  dataTable,
+  dateEvent,
+  definitionCard,
+  docToMarkdown,
+  expandCoverBlock,
+  expandDocBlocks,
+  expandPersistentLayers,
+  expandTemplateBlock,
+  factCard,
+  flattenBlocks,
+  fullBleedQuote,
+  getAccentLayout,
+  getAnimationProgress,
+  getAnimationStyle,
+  getAvailableTemplates,
+  getBlockDepth,
+  getDefaultAnimation,
+  getDefaultAnimationDuration,
+  getDocStyleConfig,
+  getLayers,
+  getOverlayOpacity,
+  getTemplateHint,
+  getThemeFont,
+  getTransitionClass,
+  hasTemplate,
+  imageWithCaption,
+  leftFeature,
+  listBlock,
+  mapBlock,
+  markdownToDoc,
+  photoGrid,
+  pullQuote,
+  quoteBlock,
+  resolveAudioMapping,
+  resolveColorScheme,
+  resolveTemplateName,
+  rightFeature,
+  scaleAnimationDuration,
+  scoreTextSimilarity,
+  sectionHeader,
+  shouldUseShadow,
+  statHighlight,
+  templateRegistry,
+  themedFontSize,
+  titleBlock,
+  twoColumn,
+  videoPullQuote,
+  videoWithCaption
+} from "../chunk-KSWJR66U.js";
+import {
+  DEFAULT_THEME,
+  getAvailableThemes,
+  getThemeSummaries,
+  resolveTheme
+} from "../chunk-B4EEON3N.js";
+import {
+  VIEWPORT_PRESETS,
+  createTemplateContext,
+  getLayoutHints,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
+  isTemplateBlock,
+  scaledFontSize2 as scaledFontSize
+} from "../chunk-5WFRKURX.js";
+import "../chunk-H3AXU4MJ.js";
+import "../chunk-4X3JQXNM.js";
+import "../chunk-3E5F2XMR.js";
+export {
+  DEFAULT_LAYOUT,
+  DEFAULT_THEME,
+  TEMPLATE_ALIASES,
+  VIEWPORT_PRESETS,
+  adjustY,
+  comparisonBar,
+  countBlocks,
+  coverBlock,
+  createAccentLayers,
+  createTemplateContext,
+  dataTable,
+  dateEvent,
+  definitionCard,
+  docToMarkdown,
+  expandCoverBlock,
+  expandDocBlocks,
+  expandPersistentLayers,
+  expandTemplateBlock,
+  factCard,
+  flattenBlocks,
+  fullBleedQuote,
+  getAccentLayout,
+  getAnimationProgress,
+  getAnimationStyle,
+  getAvailableTemplates,
+  getAvailableThemes,
+  getBlockDepth,
+  getDefaultAnimation,
+  getDefaultAnimationDuration,
+  getDocStyleConfig,
+  getLayers,
+  getLayoutHints,
+  getOverlayOpacity,
+  getTemplateHint,
+  getThemeFont,
+  getThemeSummaries,
+  getTransitionClass,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
+  hasTemplate,
+  imageWithCaption,
+  isTemplateBlock,
+  leftFeature,
+  listBlock,
+  mapBlock,
+  markdownToDoc,
+  photoGrid,
+  pullQuote,
+  quoteBlock,
+  resolveAudioMapping,
+  resolveColorScheme,
+  resolveTemplateName,
+  resolveTheme,
+  rightFeature,
+  scaleAnimationDuration,
+  scaledFontSize,
+  scoreTextSimilarity,
+  sectionHeader,
+  shouldUseShadow,
+  statHighlight,
+  templateRegistry,
+  themedFontSize,
+  titleBlock,
+  twoColumn,
+  videoPullQuote,
+  videoWithCaption
+};
 //# sourceMappingURL=index.js.map

package/dist/doc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/doc/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/generate/index.d.ts

@@ -1,7 +1,99 @@
-export { extractContent, stripMarkdown } from './contentExtractor.js';
-export type { ExtractionType, ExtractedElement, StatData, DateData, QuoteData, ComparisonData, FactData, ImpactLineData, ListData, DefinitionData, ExtractionOptions, ExtractionResult, } from './contentExtractor.js';
-export { mapElementToBlock } from './templateMapper.js';
-export type { MapOptions } from './templateMapper.js';
-export { generateSlideshow } from './slideshowGenerator.js';
-export type { SlideshowDoc, SlideshowImage, SlideshowOptions } from './slideshowGenerator.js';
-//# sourceMappingURL=index.d.ts.map
+import { E as ExtractedElement } from '../contentExtractor-BNfVJV2U.js';
+export { C as ComparisonData, D as DateData, a as DefinitionData, b as ExtractionOptions, c as ExtractionResult, d as ExtractionType, F as FactData, I as ImpactLineData, L as ListData, Q as QuoteData, S as StatData, e as extractContent, s as stripMarkdown } from '../contentExtractor-BNfVJV2U.js';
+import { j as ColorScheme, A as AccentImage, a9 as TemplateBlock, s as Doc, a as AccentPosition } from '../Doc-BeSeH2iX.js';
+import '../types-BdZkdJ3z.js';
+
+/**
+ * Template Mapper
+ *
+ * Converts extracted content elements into squisq TemplateBlock inputs.
+ * Each ExtractionType maps to a specific template from BlockTemplates.
+ */
+
+/** Options for mapping an element to a template block. */
+interface MapOptions {
+    id: string;
+    duration: number;
+    audioSegment: number;
+    colorScheme?: ColorScheme;
+    accentImage?: AccentImage;
+    sourceStartTime?: number;
+    sourceDuration?: number;
+}
+/**
+ * Convert an extracted element into the matching squisq TemplateBlock.
+ */
+declare function mapElementToBlock(element: ExtractedElement, options: MapOptions): TemplateBlock;
+
+/**
+ * Slideshow Generator
+ *
+ * Turns plain text + optional images into a complete squisq `Doc`.
+ *
+ * Pipeline:
+ * 1. Strip markdown (if needed)
+ * 2. Extract compelling content (stats, dates, quotes, …)
+ * 3. Estimate narration timing
+ * 4. Map extractions → template blocks
+ * 5. Interleave image slides
+ * 6. Return a ready-to-render `Doc`
+ */
+
+/** A Doc variant whose blocks are TemplateBlocks (no startTime required). */
+type SlideshowDoc = Omit<Doc, 'blocks'> & {
+    blocks: TemplateBlock[];
+};
+/** Image metadata passed to the generator. */
+interface SlideshowImage {
+    /** Image source path or URL. */
+    src: string;
+    /** Alt text for accessibility. */
+    alt?: string;
+    /** Photo credit. */
+    credit?: string;
+    /** License identifier. */
+    license?: string;
+}
+/** Options for `generateSlideshow`. */
+interface SlideshowOptions {
+    /** Deterministic seed (default: hash of the text). */
+    seed?: number;
+    /** Title slide text. Omit to skip the title slide. */
+    title?: string;
+    /** Subtitle for the title slide. */
+    subtitle?: string;
+    /** Explicit total duration in seconds. When omitted, estimated from text. */
+    duration?: number;
+    /** Target number of content slides (default: 5–8, auto-scaled). */
+    targetSlides?: number;
+    /** Color schemes to rotate (default: ['blue','green','purple','orange','red']). */
+    colorSchemes?: ColorScheme[];
+    /** Ambient motions to rotate on images. */
+    ambientMotions?: Array<'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight'>;
+    /** Accent positions to rotate on text slides. */
+    accentPositions?: AccentPosition[];
+    /** Minimum slide duration in seconds (default: 4). */
+    minSlideDuration?: number;
+    /** Maximum slide duration in seconds (default: 15). */
+    maxSlideDuration?: number;
+    /** Theme identifier to embed in the Doc. */
+    themeId?: string;
+    /** Whether the input text is markdown (default: false). */
+    isMarkdown?: boolean;
+    /** Minimum extraction confidence (default: 0.3). */
+    minConfidence?: number;
+}
+/**
+ * Generate a slideshow `Doc` from text and optional images.
+ *
+ * ```ts
+ * const doc = generateSlideshow(articleText, myImages, {
+ *   title: 'Mount Rainier',
+ *   themeId: 'documentary',
+ * });
+ * // doc is a complete Doc ready for DocPlayer / LinearDocView
+ * ```
+ */
+declare function generateSlideshow(text: string, images?: SlideshowImage[], options?: SlideshowOptions): SlideshowDoc;
+
+export { ExtractedElement, type MapOptions, type SlideshowDoc, type SlideshowImage, type SlideshowOptions, generateSlideshow, mapElementToBlock };

package/dist/generate/index.js

@@ -1,4 +1,17 @@
-export { extractContent, stripMarkdown } from './contentExtractor.js';
-export { mapElementToBlock } from './templateMapper.js';
-export { generateSlideshow } from './slideshowGenerator.js';
+import {
+  generateSlideshow
+} from "../chunk-MYIH7FWD.js";
+import {
+  extractContent,
+  mapElementToBlock,
+  stripMarkdown
+} from "../chunk-FR2RBTKO.js";
+import "../chunk-FVTQSNR7.js";
+import "../chunk-3E5F2XMR.js";
+export {
+  extractContent,
+  generateSlideshow,
+  mapElementToBlock,
+  stripMarkdown
+};
 //# sourceMappingURL=index.js.map

package/dist/generate/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAgBtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/icons/index.d.ts

@@ -1,12 +1,87 @@
 /**
- * Icons barrel — subpath `@bendyline/squisq/icons`.
+ * iconData.ts — GENERATED FILE
  *
- * Exposes the FontAwesome Free catalog (`ICONS`, `IconEntry`,
- * `IconFamily`) and the lookup helpers (`resolveIcon`,
- * `canonicalIconToken`, `looksLikeIconToken`).
+ * FontAwesome Free icon catalog. Run `node scripts/generate-icon-data.mjs`
+ * to regenerate after bumping @fortawesome/fontawesome-free.
+ *
+ * Entry count: 2141
+ * Generated:   2026-05-14T03:38:13.863Z
+ */
+type IconFamily = 'brands' | 'solid' | 'regular';
+interface IconEntry {
+    /** Icon name without the `fa-` prefix (e.g. `github`). */
+    name: string;
+    /** Family bucket — drives the `fa-brands` / `fa-solid` / `fa-regular` class. */
+    family: IconFamily;
+    /** Human display label (used by the picker tooltip). */
+    label: string;
+    /** Lowercase, space-joined search keywords. */
+    keywords: string;
+    /** FontAwesome Private-Use-Area codepoint as a hex string (e.g. `'f09b'`).
+     *  Use `String.fromCodePoint(parseInt(unicode, 16))` to get the rendered
+     *  glyph when the FA font is loaded. */
+    unicode: string;
+}
+declare const ICONS: IconEntry[];
+
+/**
+ * Icon Resolver
+ *
+ * Looks up a user-supplied token against the FontAwesome Free catalog.
+ *
+ * Tokens come in two forms:
+ * - **Bare** (`github`) — resolves only when the name is unique across
+ *   families. The picker prefers this form for friendliness.
+ * - **Qualified** (`fa-brands:github`, `fa-solid:user`) — required when
+ *   the name collides across families (e.g. `user` ships in both solid
+ *   and regular).
+ *
+ * Returning `null` from `resolveIcon` is a deliberate signal: callers
+ * should render the source token verbatim so authors can write
+ * `{[notathing]}` in prose without it being silently swallowed.
+ */
+
+/**
+ * True when a token looks like an icon reference. Used by the markdown
+ * parser to decide whether a `{[…]}` body in a heading is worth probing
+ * (the heading-template path already extracted the trailing annotation
+ * by the time inline detection runs).
+ */
+declare function looksLikeIconToken(token: string): boolean;
+/**
+ * Resolve a token to an icon. Returns `null` when the token is unknown
+ * OR when the bare form collides — callers should render `null` results
+ * as literal markdown text so authors can opt out by qualifying.
+ */
+declare function resolveIcon(token: string): IconEntry | null;
+/**
+ * The canonical "shortest unambiguous" token for an icon — bare if the
+ * name is unique, otherwise the qualified form. Used when serializing
+ * a resolved icon back to markdown so we don't gratuitously qualify
+ * names that don't need it.
+ */
+declare function canonicalIconToken(entry: IconEntry): string;
+/**
+ * Render the icon's Unicode codepoint as a single-character string.
+ * Returns `''` for entries without a codepoint (defensive — FA always
+ * has one). Used by editors and previews that want to display the
+ * actual glyph using the FontAwesome font; pair with the right
+ * font-family/font-weight for the icon's family.
+ */
+declare function iconGlyph(entry: IconEntry): string;
+/** Single autocomplete suggestion. `score` ranks lower-is-better:
+ *  0 = name starts-with query, 1 = name contains query,
+ *  2 = keyword contains query. */
+interface IconSuggestion {
+    entry: IconEntry;
+    token: string;
+    score: number;
+}
+/**
+ * Rank icons against a partial token typed by the user. Used by the
+ * Monaco completion provider in editor-react and re-exported so any
+ * host can build its own typeahead.
  */
-export { ICONS } from './iconData.js';
-export type { IconEntry, IconFamily } from './iconData.js';
-export { resolveIcon, canonicalIconToken, looksLikeIconToken, suggestIcons, iconGlyph, } from './resolve.js';
-export type { IconSuggestion } from './resolve.js';
-//# sourceMappingURL=index.d.ts.map
+declare function suggestIcons(query: string, limit?: number): IconSuggestion[];
+
+export { ICONS, type IconEntry, type IconFamily, type IconSuggestion, canonicalIconToken, iconGlyph, looksLikeIconToken, resolveIcon, suggestIcons };

package/dist/icons/index.js

@@ -1,10 +1,17 @@
-/**
- * Icons barrel — subpath `@bendyline/squisq/icons`.
- *
- * Exposes the FontAwesome Free catalog (`ICONS`, `IconEntry`,
- * `IconFamily`) and the lookup helpers (`resolveIcon`,
- * `canonicalIconToken`, `looksLikeIconToken`).
- */
-export { ICONS } from './iconData.js';
-export { resolveIcon, canonicalIconToken, looksLikeIconToken, suggestIcons, iconGlyph, } from './resolve.js';
+import {
+  ICONS,
+  canonicalIconToken,
+  iconGlyph,
+  looksLikeIconToken,
+  resolveIcon,
+  suggestIcons
+} from "../chunk-DBS6RIFL.js";
+export {
+  ICONS,
+  canonicalIconToken,
+  iconGlyph,
+  looksLikeIconToken,
+  resolveIcon,
+  suggestIcons
+};
 //# sourceMappingURL=index.js.map

package/dist/icons/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/icons/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,SAAS,GACV,MAAM,cAAc,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/imageEdit/index.d.ts

@@ -1,14 +1,216 @@
+import { a as ImageEditDoc, b as ImageEditLayer } from '../ImageEditDoc-BTIvw0oq.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-BTIvw0oq.js';
+import { C as ContentContainer } from '../ContentContainer-DNx460y8.js';
+import { V as Version, C as CoalesceOptions, P as PrunePolicy } from '../types-D98li1gV.js';
+import '../Doc-BeSeH2iX.js';
+import '../types-BdZkdJ3z.js';
+
 /**
- * Image-editor primitives: schema re-exports, state helpers, persistence,
- * version history, and SVG → raster export.
+ * Pure helpers for constructing and mutating {@link ImageEditDoc} values.
  *
- * See `@bendyline/squisq/imageEdit` for the public subpath entry.
+ * All functions are side-effect free and return new doc objects rather
+ * than mutating their inputs, so they're safe to use from a reducer.
  */
-export type { ImageEditDoc, ImageEditLayer, ImageEditLayerKind, ImageEditCanvas, ImageEditMeta, EditorLayerMeta, } from '../schemas/ImageEditDoc.js';
-export { IMAGE_EDIT_STATE_FILENAME, IMAGE_EDIT_ASSETS_PREFIX, createEmptyImageEditDoc, addLayer, removeLayer, reorderLayer, updateLayer, setCanvas, touch, } from './state.js';
-export { readImageEditDoc, writeImageEditDoc } from './persistence.js';
-export { IMAGE_EDIT_VERSIONS_PREFIX, IMAGE_EDIT_DEFAULT_BASENAME, buildImageEditVersionPath, parseImageEditVersionPath, } from './versionPaths.js';
-export { saveImageEditVersion, listImageEditVersions, readImageEditVersion, readImageEditVersionText, revertToImageEditVersion, pruneImageEditVersions, coalesceImageEditVersions, type SaveImageEditVersionOptions, type SaveImageEditVersionResult, type RevertImageEditOptions, } from './versions.js';
-export { ImageEditVersionManager, type ImageEditVersionManagerOptions, } from './ImageEditVersionManager.js';
-export { exportImageEditDoc, type ImageEditExportFormat, type ImageEditExportOptions, } from './export.js';
-//# sourceMappingURL=index.d.ts.map
+
+/** Filename used for the persisted editor state inside the sidecar. */
+declare const IMAGE_EDIT_STATE_FILENAME = "state.json";
+/** Subfolder (inside the sidecar) for embedded asset bytes. */
+declare const IMAGE_EDIT_ASSETS_PREFIX = "assets/";
+/**
+ * Create an empty doc with the given canvas size and no layers.
+ *
+ * `meta.createdAt` and `meta.updatedAt` are set to the current time so
+ * the doc has a complete metadata footprint from the start.
+ */
+declare function createEmptyImageEditDoc(width: number, height: number, options?: {
+    background?: string;
+    sourcePath?: string;
+    now?: Date;
+}): ImageEditDoc;
+/** Append a layer (top of stack). Assigns an id when missing. */
+declare function addLayer(doc: ImageEditDoc, layer: ImageEditLayer): ImageEditDoc;
+/** Remove the layer with the given id. No-op if not found. */
+declare function removeLayer(doc: ImageEditDoc, layerId: string): ImageEditDoc;
+/**
+ * Reorder a layer to a new index in the stack. The index is clamped to
+ * the valid range; out-of-range / missing layers are no-ops.
+ */
+declare function reorderLayer(doc: ImageEditDoc, layerId: string, toIndex: number): ImageEditDoc;
+/**
+ * Replace the layer with the given id by applying a partial update.
+ * The patch is shallow-merged at the top level; callers updating
+ * `content`, `position`, etc. must spread those sub-objects themselves.
+ */
+declare function updateLayer(doc: ImageEditDoc, layerId: string, patch: Partial<ImageEditLayer>): ImageEditDoc;
+/** Replace the canvas configuration. */
+declare function setCanvas(doc: ImageEditDoc, canvas: ImageEditDoc['canvas']): ImageEditDoc;
+/** Bump `meta.updatedAt`. Pure: returns a new doc. */
+declare function touch(doc: ImageEditDoc, now?: Date): ImageEditDoc;
+
+/**
+ * Load and save {@link ImageEditDoc} JSON to a sidecar
+ * {@link ContentContainer} (typically a {@link ScopedContentContainer}
+ * rooted at `<basename>_files/`).
+ */
+
+/**
+ * Read `state.json` from the sidecar and parse it. Returns `null` when
+ * the file does not exist; throws on parse / shape errors.
+ */
+declare function readImageEditDoc(container: ContentContainer, filename?: string): Promise<ImageEditDoc | null>;
+/** Serialize `doc` to JSON and write it to the sidecar. */
+declare function writeImageEditDoc(container: ContentContainer, doc: ImageEditDoc, filename?: string): Promise<void>;
+
+/**
+ * Path conventions for image-editor version snapshots.
+ *
+ * Snapshots live inside the sidecar at
+ * `.versions/<basename>.<timestamp>[<-suffix>].json`. The collision
+ * suffix (`-2`, `-3`, ...) is appended only when two snapshots land on
+ * the same UTC second.
+ *
+ * Mirrors `core/src/versions/paths.ts` but keyed on `.json` instead of
+ * `.md` so the two histories live side-by-side without colliding.
+ */
+/** Subfolder (inside the sidecar) that holds image-editor snapshots. */
+declare const IMAGE_EDIT_VERSIONS_PREFIX = ".versions/";
+/** Default basename when none is supplied. Matches `IMAGE_EDIT_STATE_FILENAME` stem. */
+declare const IMAGE_EDIT_DEFAULT_BASENAME = "state";
+/** Build a snapshot path. Optionally append a collision suffix. */
+declare function buildImageEditVersionPath(basename: string, date: Date, collision?: number): string;
+/**
+ * Parse a snapshot path. Returns `null` when the path doesn't match the
+ * convention (so unrelated `.versions/*.json` files are ignored).
+ */
+declare function parseImageEditVersionPath(path: string): {
+    basename: string;
+    timestamp: Date;
+    collision: number;
+} | null;
+
+/**
+ * Image-editor version operations against a sidecar
+ * {@link ContentContainer}.
+ *
+ * Mirrors `core/src/versions/operations.ts` but operates on
+ * {@link ImageEditDoc} JSON state at `.versions/<basename>.<timestamp>.json`
+ * instead of the markdown document. Reuses {@link PrunePolicy} so hosts
+ * can share their pruning configuration between the two histories.
+ */
+
+/** Options for {@link saveImageEditVersion}. */
+interface SaveImageEditVersionOptions {
+    /** Override the doc to snapshot; otherwise `state.json` is read from the sidecar. */
+    doc?: ImageEditDoc;
+    /** Override the snapshot timestamp. Defaults to `new Date()`. */
+    now?: Date;
+    /** Skip the diff-vs-latest check and force a write. */
+    force?: boolean;
+    /** Override the basename used in version filenames. Defaults to `'state'`. */
+    basename?: string;
+    /** Override the source filename inside the sidecar. Defaults to `state.json`. */
+    stateFilename?: string;
+}
+/** Result of a {@link saveImageEditVersion} call. */
+interface SaveImageEditVersionResult {
+    saved: boolean;
+    version: Version | null;
+    /** `'saved' | 'unchanged' | 'no-state'` — `'no-state'` means there was nothing to snapshot. */
+    reason: 'saved' | 'unchanged' | 'no-state';
+}
+/** Options for {@link revertToImageEditVersion}. */
+interface RevertImageEditOptions {
+    /**
+     * Whether to snapshot the *current* state before replacing it. Defaults to `true`.
+     */
+    snapshotCurrent?: boolean;
+    /** Override the source filename. Defaults to `state.json`. */
+    stateFilename?: string;
+}
+/** List image-edit snapshots in the sidecar, newest-first. */
+declare function listImageEditVersions(container: ContentContainer, basename?: string): Promise<Version[]>;
+/** Read a snapshot's JSON text. Returns `null` if the snapshot is missing. */
+declare function readImageEditVersionText(container: ContentContainer, version: Version | string): Promise<string | null>;
+/** Read and parse a snapshot. Returns `null` if missing. */
+declare function readImageEditVersion(container: ContentContainer, version: Version | string): Promise<ImageEditDoc | null>;
+/**
+ * Snapshot the current image-editor state if it differs from the latest
+ * existing snapshot.
+ *
+ * Diff is computed on the *serialized* JSON (with stable 2-space
+ * indentation) so semantically-equal states with different key order
+ * still snapshot — accept the over-snapshot rather than running a deep
+ * structural compare.
+ */
+declare function saveImageEditVersion(container: ContentContainer, options?: SaveImageEditVersionOptions): Promise<SaveImageEditVersionResult>;
+/** Revert `state.json` to a prior snapshot. Snapshots the current state first by default. */
+declare function revertToImageEditVersion(container: ContentContainer, version: Version | string, options?: RevertImageEditOptions): Promise<{
+    reverted: boolean;
+    snapshotted: Version | null;
+}>;
+/** Delete snapshots that don't satisfy the policy. */
+declare function pruneImageEditVersions(container: ContentContainer, policy: PrunePolicy, basename?: string): Promise<Version[]>;
+/** Collapse adjacent snapshots within `windowMs`, keeping the newer of each pair. */
+declare function coalesceImageEditVersions(container: ContentContainer, options?: CoalesceOptions, basename?: string): Promise<Version[]>;
+
+/**
+ * Convenience wrapper around the image-edit version operations that
+ * captures a {@link ContentContainer} reference and an optional basename
+ * override. Mirrors `DocumentVersionManager` in shape.
+ */
+
+interface ImageEditVersionManagerOptions {
+    /** Override the basename used in version filenames. Defaults to `'state'`. */
+    basename?: string;
+    /** Override the source filename inside the sidecar. Defaults to `state.json`. */
+    stateFilename?: string;
+}
+declare class ImageEditVersionManager {
+    private readonly container;
+    private readonly basename;
+    private readonly stateFilename;
+    constructor(container: ContentContainer, options?: ImageEditVersionManagerOptions);
+    saveVersion(options?: SaveImageEditVersionOptions): Promise<SaveImageEditVersionResult>;
+    listVersions(): Promise<Version[]>;
+    readVersion(version: Version | string): Promise<ImageEditDoc | null>;
+    revertToVersion(version: Version | string, options?: RevertImageEditOptions): Promise<{
+        reverted: boolean;
+        snapshotted: Version | null;
+    }>;
+    pruneVersions(policy: PrunePolicy): Promise<Version[]>;
+    coalesceVersions(options?: CoalesceOptions): Promise<Version[]>;
+}
+
+/**
+ * Rasterize an {@link ImageEditDoc} to a PNG / JPEG / WebP {@link Blob}.
+ *
+ * The pipeline:
+ *   1. Build an SVG string mirroring the canvas + layers, with image
+ *      hrefs inlined as `data:` URLs (so the canvas isn't tainted).
+ *   2. Wrap the SVG in a `Blob` and load it through an `Image`.
+ *   3. Draw it onto a canvas (`OffscreenCanvas` when available,
+ *      otherwise a detached `HTMLCanvasElement`).
+ *   4. Convert the canvas to the requested format.
+ *
+ * Browser-only — calls `Image`, `URL.createObjectURL`, and canvas APIs.
+ * Returns a Promise that rejects on SVG parse / load failures.
+ */
+
+/** Supported export formats. */
+type ImageEditExportFormat = 'png' | 'jpeg' | 'webp';
+/** Options for {@link exportImageEditDoc}. */
+interface ImageEditExportOptions {
+    /** Output format. Defaults to `'png'`. */
+    format?: ImageEditExportFormat;
+    /** JPEG/WebP quality 0..1. Defaults to `0.92`. Ignored for PNG. */
+    quality?: number;
+    /** Resolution scale factor. Defaults to `1` (canvas pixels = output pixels). */
+    scale?: number;
+}
+/**
+ * Export the doc to a raster {@link Blob}. Asset bytes referenced by image
+ * layers are read from `container` and inlined as data URLs.
+ */
+declare function exportImageEditDoc(doc: ImageEditDoc, container: ContentContainer, options?: ImageEditExportOptions): Promise<Blob>;
+
+export { IMAGE_EDIT_ASSETS_PREFIX, IMAGE_EDIT_DEFAULT_BASENAME, IMAGE_EDIT_STATE_FILENAME, IMAGE_EDIT_VERSIONS_PREFIX, ImageEditDoc, type ImageEditExportFormat, type ImageEditExportOptions, ImageEditLayer, ImageEditVersionManager, type ImageEditVersionManagerOptions, type RevertImageEditOptions, type SaveImageEditVersionOptions, type SaveImageEditVersionResult, addLayer, buildImageEditVersionPath, coalesceImageEditVersions, createEmptyImageEditDoc, exportImageEditDoc, listImageEditVersions, parseImageEditVersionPath, pruneImageEditVersions, readImageEditDoc, readImageEditVersion, readImageEditVersionText, removeLayer, reorderLayer, revertToImageEditVersion, saveImageEditVersion, setCanvas, touch, updateLayer, writeImageEditDoc };